.. _`Set column names in Table with Table`:

.. _`org.sysess.sympathy.setcolumnnamesintablewithtable`:

Set column names in Table with Table
````````````````````````````````````

.. image:: rename_columns.svg
   :width: 48


Set column names from separate table column.




Documentation
:::::::::::::

Set column names in data table to new names from chosen column in the name
table.

Since the new names are assigned based on indices, the number of rows in
the name column must match the number of columns in the data table.


Example
=======

Input data:

+---+---+---+
| A | B | C |
+===+===+===+
| 0 | 1 | 2 |
+---+---+---+


Input names:

+-------+
| Names |
+=======+
|   X   |
+-------+
|   Y   |
+-------+
|   Z   |
+-------+


Output data:

+---+---+---+
| X | Y | Z |
+===+===+===+
| 0 | 1 | 2 |
+---+---+---+


Definition
::::::::::


Input ports
===========

    **data**  table
        Data

    **name**  table
        Name


Output ports
============

    **data**  table
        Data




Configuration
=============

    **New names** (name)
        Column with new names





Related nodes
=============

* :ref:`org.sysess.sympathy.setcolumnnamesintableswithtable`

* :ref:`org.sysess.sympathy.getcolumnnamesintable`

* :ref:`org.sysess.sympathy.data.table.renamesingletablecolumns`




Examples
========

* :download:`RenameColumnsInTable.syx </Examples/Sympathy/Data Processing/Structure/RenameColumnsInTable.syx>`




Implementation
==============

.. automodule:: node_set_column_names
    :noindex:

.. class:: SetColumnNamesInTableWithTable
    :noindex: